<?xml version="1.0" encoding="iso-8859-1" standalone="no"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
  <head>
    <meta http-equiv="Content-Type" content=
    "application/xhtml+xml; charset=iso-8859-1" />
    <title>
      Wireless Tools-29
    </title>
    <link rel="stylesheet" type="text/css" href="../stylesheets/lfs.css" />
    <meta name="generator" content="DocBook XSL Stylesheets V1.78.1" />
    <link rel="stylesheet" href="../stylesheets/lfs-print.css" type=
    "text/css" media="print" />
  </head>
  <body class="blfs" id="blfs-2020-04-02">
    <div class="navheader">
      <h4>
        Beyond Linux<sup>�</sup> From Scratch <span class="phrase">(System
        V</span> Edition) - Version 2020-04-02
      </h4>
      <h3>
        Chapter&nbsp;15.&nbsp;Networking Programs
      </h3>
      <ul>
        <li class="prev">
          <a accesskey="p" href="wget.html" title="Wget-1.20.3">Prev</a>
          <p>
            Wget-1.20.3
          </p>
        </li>
        <li class="next">
          <a accesskey="n" href="wpa_supplicant.html" title=
          "wpa_supplicant-2.9">Next</a>
          <p>
            wpa_supplicant-2.9
          </p>
        </li>
        <li class="up">
          <a accesskey="u" href="netprogs.html" title=
          "Chapter&nbsp;15.&nbsp;Networking Programs">Up</a>
        </li>
        <li class="home">
          <a accesskey="h" href="../index.html" title=
          "Beyond Linux� From Scratch     (System V Edition) - Version 2020-04-02">
          Home</a>
        </li>
      </ul>
    </div>
    <div class="sect1" lang="en" xml:lang="en">
      <h1 class="sect1">
        <a id="wireless_tools" name="wireless_tools"></a>Wireless Tools-29
      </h1>
      <div class="package" lang="en" xml:lang="en">
        <h2 class="sect2">
          Introduction to Wireless Tools
        </h2>
        <p>
          The Wireless Extension (WE) is a generic API in the Linux kernel
          allowing a driver to expose configuration and statistics specific
          to common Wireless LANs to user space. A single set of tools can
          support all the variations of Wireless LANs, regardless of their
          type as long as the driver supports Wireless Extensions. WE
          parameters may also be changed on the fly without restarting the
          driver (or Linux).
        </p>
        <p>
          The <span class="application">Wireless Tools</span> (WT) package is
          a set of tools allowing manipulation of the Wireless Extensions.
          They use a textual interface to support the full Wireless
          Extension.
        </p>
        <p>
          This package is known to build and work properly using an LFS-9.1
          platform.
        </p>
        <h3>
          Package Information
        </h3>
        <div class="itemizedlist">
          <ul class="compact">
            <li class="listitem">
              <p>
                Download (HTTP): <a class="ulink" href=
                "https://hewlettpackard.github.io/wireless-tools/wireless_tools.29.tar.gz">
                https://hewlettpackard.github.io/wireless-tools/wireless_tools.29.tar.gz</a>
              </p>
            </li>
            <li class="listitem">
              <p>
                Download MD5 sum: e06c222e186f7cc013fd272d023710cb
              </p>
            </li>
            <li class="listitem">
              <p>
                Download size: 288 KB
              </p>
            </li>
            <li class="listitem">
              <p>
                Estimated disk space required: 2.0 MB
              </p>
            </li>
            <li class="listitem">
              <p>
                Estimated build time: less than 0.1 SBU
              </p>
            </li>
          </ul>
        </div>
        <h3>
          Additional Downloads
        </h3>
        <div class="itemizedlist">
          <ul class="compact">
            <li class="listitem">
              <p>
                Required patch: <a class="ulink" href=
                "http://www.linuxfromscratch.org/patches/blfs/svn/wireless_tools-29-fix_iwlist_scanning-1.patch">
                http://www.linuxfromscratch.org/patches/blfs/svn/wireless_tools-29-fix_iwlist_scanning-1.patch</a>
              </p>
            </li>
          </ul>
        </div>
        <p class="usernotes">
          User Notes: <a class="ulink" href=
          "http://wiki.linuxfromscratch.org/blfs/wiki/WirelessTools">http://wiki.linuxfromscratch.org/blfs/wiki/WirelessTools</a>
        </p>
      </div>
      <div class="kernel" lang="en" xml:lang="en">
        <h2 class="sect2">
          <a id="wireless-kernel" name="wireless-kernel"></a>Kernel
          Configuration
        </h2>
        <p>
          To use <span class="application">Wireless Tools</span>, the kernel
          must have the appropriate drivers and other support available. The
          appropriate bus must also be available. For many laptops, the
          PCMCIA bus (CONFIG_PCCARD) needs to be built. In some cases, this
          bus support will also need to be built for embedded wireless cards.
          The appropriate bridge support also needs to be built. For many
          modern laptops, the CardBus host bridge (CONFIG_YENTA) will be
          needed.
        </p>
        <p>
          In addition to the bus, the actual driver for the specific wireless
          card must also be available. There are many wireless cards and they
          don't all work with Linux. The first place to look for card support
          is the kernel. The drivers are located in Device Drivers &rarr;
          Network Device Support &rarr; Wireless LAN (non-hamradio). There
          are also external drivers available for some very common cards. For
          more information, look at the user notes.
        </p>
        <p>
          After the correct drivers are loaded, the interface will appear in
          <code class="filename">/proc/net/wireless</code>.
        </p>
      </div>
      <div class="installation" lang="en" xml:lang="en">
        <h2 class="sect2">
          Installation of Wireless Tools
        </h2>
        <p>
          First, apply a patch that fixes a problem when numerous networks
          are available:
        </p>
        <pre class="userinput">
<kbd class=
"command">patch -Np1 -i ../wireless_tools-29-fix_iwlist_scanning-1.patch</kbd>
</pre>
        <p>
          To install <span class="application">Wireless Tools</span>, use the
          following commands:
        </p>
        <pre class="userinput">
<kbd class="command">make</kbd>
</pre>
        <p>
          This package does not come with a test suite.
        </p>
        <p>
          Now, as the <code class="systemitem">root</code> user:
        </p>
        <pre class="root">
<kbd class=
"command">make PREFIX=/usr INSTALL_MAN=/usr/share/man install</kbd>
</pre>
      </div>
      <div class="commands" lang="en" xml:lang="en">
        <h2 class="sect2">
          Command Explanations
        </h2>
        <p>
          <span class=
          "command"><strong>INSTALL_MAN=/usr/share/man</strong></span>:
          Install manual pages in <code class=
          "filename">/usr/share/man</code> instead of <code class=
          "filename">/usr/man</code>.
        </p>
      </div>
      <div class="content" lang="en" xml:lang="en">
        <h2 class="sect2">
          Contents
        </h2>
        <div class="segmentedlist">
          <div class="seglistitem">
            <div class="seg">
              <strong class="segtitle">Installed Programs:</strong>
              <span class="segbody">ifrename, iwconfig, iwevent, iwgetid,
              iwlist, iwpriv, and iwspy</span>
            </div>
            <div class="seg">
              <strong class="segtitle">Installed Library:</strong>
              <span class="segbody">libiw.so</span>
            </div>
            <div class="seg">
              <strong class="segtitle">Installed Directories:</strong>
              <span class="segbody">None</span>
            </div>
          </div>
        </div>
        <div class="variablelist">
          <h3>
            Short Descriptions
          </h3>
          <table border="0" class="variablelist">
            <colgroup>
              <col align="left" valign="top" />
              <col />
            </colgroup>
            <tbody>
              <tr>
                <td>
                  <p>
                    <a id="ifrename" name="ifrename"></a><span class=
                    "term"><span class=
                    "command"><strong>ifrename</strong></span></span>
                  </p>
                </td>
                <td>
                  <p>
                    renames network interfaces based on various static
                    criteria.
                  </p>
                </td>
              </tr>
              <tr>
                <td>
                  <p>
                    <a id="iwconfig" name="iwconfig"></a><span class=
                    "term"><span class=
                    "command"><strong>iwconfig</strong></span></span>
                  </p>
                </td>
                <td>
                  <p>
                    configures a wireless network interface.
                  </p>
                </td>
              </tr>
              <tr>
                <td>
                  <p>
                    <a id="iwevent" name="iwevent"></a><span class=
                    "term"><span class=
                    "command"><strong>iwevent</strong></span></span>
                  </p>
                </td>
                <td>
                  <p>
                    displays wireless events generated by drivers and setting
                    changes.
                  </p>
                </td>
              </tr>
              <tr>
                <td>
                  <p>
                    <a id="iwgetid" name="iwgetid"></a><span class=
                    "term"><span class=
                    "command"><strong>iwgetid</strong></span></span>
                  </p>
                </td>
                <td>
                  <p>
                    reports ESSID, NWID or AP/Cell Address of wireless
                    networks.
                  </p>
                </td>
              </tr>
              <tr>
                <td>
                  <p>
                    <a id="iwlist" name="iwlist"></a><span class=
                    "term"><span class=
                    "command"><strong>iwlist</strong></span></span>
                  </p>
                </td>
                <td>
                  <p>
                    gets detailed wireless information from a wireless
                    interface.
                  </p>
                </td>
              </tr>
              <tr>
                <td>
                  <p>
                    <a id="iwpriv" name="iwpriv"></a><span class=
                    "term"><span class=
                    "command"><strong>iwpriv</strong></span></span>
                  </p>
                </td>
                <td>
                  <p>
                    configures optional (private) parameters of a wireless
                    network interface.
                  </p>
                </td>
              </tr>
              <tr>
                <td>
                  <p>
                    <a id="iwspy" name="iwspy"></a><span class=
                    "term"><span class=
                    "command"><strong>iwspy</strong></span></span>
                  </p>
                </td>
                <td>
                  <p>
                    gets wireless statistics from specific node.
                  </p>
                </td>
              </tr>
              <tr>
                <td>
                  <p>
                    <a id="libiw" name="libiw"></a><span class=
                    "term"><code class="filename">libiw.so</code></span>
                  </p>
                </td>
                <td>
                  <p>
                    contains functions required by the wireless programs and
                    provides an API for other programs.
                  </p>
                </td>
              </tr>
            </tbody>
          </table>
        </div>
      </div>
      <p class="updated">
        Last updated on 2020-03-22 10:52:07 -0500
      </p>
    </div>
    <div class="navfooter">
      <ul>
        <li class="prev">
          <a accesskey="p" href="wget.html" title="Wget-1.20.3">Prev</a>
          <p>
            Wget-1.20.3
          </p>
        </li>
        <li class="next">
          <a accesskey="n" href="wpa_supplicant.html" title=
          "wpa_supplicant-2.9">Next</a>
          <p>
            wpa_supplicant-2.9
          </p>
        </li>
        <li class="up">
          <a accesskey="u" href="netprogs.html" title=
          "Chapter&nbsp;15.&nbsp;Networking Programs">Up</a>
        </li>
        <li class="home">
          <a accesskey="h" href="../index.html" title=
          "Beyond Linux� From Scratch     (System V Edition) - Version 2020-04-02">
          Home</a>
        </li>
      </ul>
    </div>
  </body>
</html>
